楽天ペイ概要 | マルペイDocs

楽天ペイ（オンライン決済）概要

楽天ペイ（オンライン決済）とは

楽天ペイ（オンライン決済）とは楽天会員を対象としたオンライン決済サービスです。
楽天IDに登録したクレジットカードや、楽天ポイントの残高を利用して、商品等の代金を支払うことができます。
本ドキュメントでは「楽天ペイ（オンライン決済）」について楽天ペイと表記します。

処理フロー説明

購入（お客様→加盟店様）
決済処理（加盟店様→当サービス）
決済処理（当サービス→楽天）
支払情報URL発行（楽天→当サービス）
決済結果返却
楽天認証画面表示（加盟店様→お客様）
認証操作（お客様→楽天）
決済完了通知（楽天→当サービス）
決済完了通知（当サービス→加盟店様）
商品/サービス提供
入金（楽天→加盟店様）

運用例

仮売上/実売上運用

楽天ペイでは、お取り扱い商材によりご契約が異なり、運用が異なります。

仮売上／実売上運用は、物販を行われている加盟店様向けの運用となります。
仮売上でお客様のご利用枠を抑えておき、売上が確定したタイミングで実売上へ変更してお客様への請求を行います。

即時売上運用

即時売上は、仮売上と実売上を同時に行う処理となります。
即時売上運用は、デジタルコンテンツを商材とされる加盟店様向けの運用となります。

取引状態

取引状態		説明
未決済	UNPROCESSED	決済が完了していない状態（お客様がご注文途中に離脱が主な原因）
要求成功	REQSUCCESS	決済準備が整った状態（楽天IDでの認証前。まだお客様は支払っていません。）
決済開始	PAYSTART	楽天IDでの認証中の状態（まだお客様は支払っていません。）
仮売上	AUTH	決済が正常に完了し、ご利用枠を確保した状態（お客様への請求は発生しません。また実売上時にエラーになることがあります。）
実売上受付	REQSALES	売上確定要求が成功した状態（まだ売上は確定していません。）
実売上	SALES	仮売上後に売上が確定した状態
即時売上受付	REQCAPTURE	売上確定要求が成功した状態（まだ売上は確定していません。）
即時売上	CAPTURE	売上が確定した状態
キャンセル受付	REQCANCEL	キャンセル要求が成功した状態（まだキャンセルは確定していません。）
キャンセル	CANCEL	キャンセルが確定した状態
金額変更受付	REQCHANGE	金額変更要求が成功した状態（まだ金額変更は確定していません。）
決済失敗	PAYFAIL	入力誤りやシステムトラブル等の何らかの原因でお支払いに失敗してしまった状態
期限切れ	EXPIRED	お客様がお支払いされることなく、有効期限が切れてしまった状態（お支払いいただくためには、再度ご注文いただく必要があります）

取引状態遷移

各操作を行った際の取引状態の遷移です。
「－」は、該当する結果、もしくは操作がないことを表しています。

操作	操作結果	操作前の状態	操作後の状態
取引登録	－	－	未決済
決済実行	成功	未決済	要求成功
決済実行	失敗	未決済	未決済
決済開始手続きIFの呼び出し	成功	要求成功	決済開始
決済開始手続きIFの呼び出し	失敗	要求成功	要求成功
お客様が楽天ペイにて認証、支払操作完了後の決済処理	成功	決済開始	仮売上／即時売上
お客様が楽天ペイにて認証、支払操作完了後の決済処理	失敗	決済開始	決済失敗
お客様が楽天ペイにて認証、申込後の決済処理	成功	決済開始	申込完了
お客様が楽天ペイにて認証、申込後の決済処理	失敗	決済開始	決済失敗
実売上	成功	仮売上	実売上受付(※1)
実売上	失敗	仮売上	仮売上
キャンセル	成功	仮売上／実売上／即時売上	キャンセル受付(※1)
キャンセル	失敗	仮売上／実売上／即時売上	仮売上／実売上／即時売上
金額変更	成功	仮売上／実売上／即時売上	仮売上／実売上／即時売上
金額変更	失敗	仮売上／実売上／即時売上	仮売上／実売上／即時売上
操作が未完了で支払期限切れ	－	要求成功	期限切れ
当サービスによる楽天ペイとの同期処理(※2)	成功	実売上受付	実売上
当サービスによる楽天ペイとの同期処理(※2)	失敗	実売上受付	仮売上
当サービスによる楽天ペイとの同期処理(※2)	成功	キャンセル受付	キャンセル
当サービスによる楽天ペイとの同期処理(※2)	失敗	キャンセル受付	仮売上／実売上（キャンセル実施前の状態）
当サービスによる楽天ペイとの同期処理(※2)	成功	金額変更受付	仮売上
当サービスによる楽天ペイとの同期処理(※2)	失敗	金額変更受付	仮売上／実売上（金額変更実施前の状態）
当サービスによる楽天ペイとの同期処理(※2)	成功	仮売上受付	仮売上
当サービスによる楽天ペイとの同期処理(※2)	失敗	仮売上受付	決済失敗
当サービスによる楽天ペイとの同期処理(※2)	成功	即時売上受付	即時売上
当サービスによる楽天ペイとの同期処理(※2)	失敗	即時売上受付	決済失敗

上記は、左欄の操作が行われた場合、状態がどうなっているかを表しています。
「－」は、該当する結果、若しくは操作がないことを表しています。
※1 処理受付後に当サービスが楽天ペイとの同期処理を行います。
※2 楽天ペイ側での処理が非同期のため状態遷移には 5分～60分ほどかかります。
テスト環境においては、同タイミングで状態遷移が行われます。

取引状態における可能操作

取引状態	取引登録	決済実行	支払手続き開始	仮売上	実売上	キャンセル	金額変更
未決済	-	〇	-	-	-	-	-
要求成功	-	-	〇	-	-	-	-
仮売上	-	-	-	-	〇	〇	〇
即時売上	-	-	-	-	-	〇	-
実売上	-	-	-	-	-	〇	〇
キャンセル	-	-	-	-	-	-	-
決済失敗	-	-	-	-	-	-	-
期限切れ	-	-	-	-	-	-	-

接続方式別の対応状況

接続方式	対応状況
プロトコルタイプ	○
モジュールタイプ	○
リンクタイプPlus	○

注意事項

内容	説明
利用可能な決済金額	100～99,999,999円利用金額+税送料の合計金額になります。
売上確定期限	売上の確定＜実売上＞は仮売上後、5ヵ月後末日までです。仮売上有効期限切れの60日経過後は、再度ご利用枠を確保後、売上確定となります。再度ご利用枠を確保するため、エラーになる可能性があります。期限を超過した場合はエラーとなり売上の確定はできません。
ご契約について	楽天ペイでは、商材ごとにご契約が異なり、運用（仮売上／実売上　もしくは即時売上）も異なります。ご契約の詳細につきましては、営業担当までご相談ください。
キャンセル	仮売上のキャンセルは、仮売上後5ヶ月後の末日までです。実売上／即時売上のキャンセルは、実売上後／即時売上後の翌月末日までです。取引のキャンセルは1オーダーあたり1度のみ可能です。
金額変更	取引の金額変更は、仮売上／実売上運用の場合のみ可能です。即時売上運用の場合、金額変更はできません。仮売上の金額変更は、初回決済時より5ヵ月後末日までです。実売上の金額変更は、実売上後の翌月末日までです。
楽天ペイについて	「楽天ペイ」は「楽天ペイ（オンライン決済）V2」とは別サービスになります。本仕様書は「楽天ペイ（オンライン決済）」になります。「楽天ペイ（オンライン決済）V2」をご利用の加盟店様は別ドキュメントになりますのでご契約をご確認ください。

ロゴについて

必ずロゴマーク利用ガイドラインをご確認の上ご利用ください。

ロゴ

ロゴはデザイン、カラーを変更せず十分な余白を用意し、そのままの状態でご利用ください。

【大】300×88	https://checkout.rakuten.co.jp/rpay/logo/s_sb_30088.jpg
【中】200×59	https://checkout.rakuten.co.jp/rpay/logo/s_sb_20059.jpg
【小】100×30	https://checkout.rakuten.co.jp/rpay/logo/s_sb_10030.jpg
【大】140×127	https://checkout.rakuten.co.jp/rpay/logo/w_wb_140127.jpg
【中】100×91	https://checkout.rakuten.co.jp/rpay/logo/w_wb_10091.jpg
【小】60×55	https://checkout.rakuten.co.jp/rpay/logo/w_wb_6055.jpg